home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 401-425 / disk_415 / uedit / readme.demo < prev    next >
Text File  |  1992-05-06  |  3KB  |  68 lines
  1. readme.demo        Kerry Zimmerman [71470,1340]        April 15, 1989
  2.                 4427 Rosada Street
  3.                 Long Beach, Ca 90815
  4.  
  5.  
  6. This archive contains the following files:
  7.  
  8.     readme.demo        This file
  9.     config!r        Very modified version of the Uedit AREXX interface
  10.     REXXCOMM        Sample AREXX to Uedit commands database
  11.     demofile        A file used by the AREXX demo
  12.     demo.urexx        A demonstration of the new AREXX/Uedit interface
  13.  
  14.  
  15. The purpose of the archive is to introduce a new Uedit interface for
  16. AREXX.  The original interface was cryptic, non-intuitive and somewhat
  17. difficult to use.  In addition, it made AREXX interface programs for
  18. Uedit difficult to read, which is bad because one of the nice parts of
  19. the AREXX language is its English-like structure.
  20.  
  21. The new interface uses a data file called REXXCOMM, that associates
  22. a command name to a series of MacroNums and InputChars.  This allows
  23. the command names to be used in Uedit's AREXX programs.
  24.  
  25. REXXCOMM is just an ascii file that can be edited with Uedit.  However,
  26. since it is a bother to have to look up the MacroNums, a utility has been
  27. built into Uedit to make adding new commands easy.  The utility is invoked
  28. by "altctl-0" (thats alt control ZER0).  It first asks for a command name.
  29. Enter the string you want followed by pmESC.  Next, the utility waits
  30. for you to enter the keystrokes to be associated with the command string.
  31. End the list with another pmESC.  Finally, save the file (f2 or f3).
  32.  
  33. Using the commands from AREXX is easy.  
  34. (Be sure Uedit's autotraffic mode is ON by using altctl-9.)  
  35. Simple one-liners are possible from a CLI.   For example:         
  36.             rx u loadfile 'myfile'
  37. tells uedit to load the file, "myfile".
  38.  
  39. More interesting things can be done from a full AREXX script.
  40. Begin the script by telling AREXX you want commands to be sent to Uedit
  41. by using: 
  42.  
  43.         address 'URexx'
  44.  
  45. Next, tell AREXX you want Uedit to send back result strings by
  46.  
  47.         options results
  48.  
  49. Now you can create a script that contains the commands you created in
  50. the REXXCOMM database.  Anytime a response is supposed to be returned
  51. from the command, it will be in the AREXX variable, 'result'.
  52.  
  53. For example, a command called 'ask' will put up a yes/no requestor
  54. and return 'YES' or 'NO' in the result variable.  
  55.  
  56. The file demo.urexx demonstrates the usage of this new AREXX interface.
  57. Put REXXCOMM, demo.urexx and demofile in a directory.  Start uedit and
  58. compile the new config!r.  Now turn on autotraffic mode with alt-ctl-9.
  59. Let's start the demo from with Uedit.  To do this, use alt-ctl-1 to edit
  60. the AREXX output buffer.  Clear any old contents and enter "demo".
  61. Now lets start the demonstration by sending the output buffer with
  62. alt-ctl-3.  (Be sure you have started the rxmaster program so the 
  63. resident Arexx program is running).
  64.  
  65. You will see some cursor movements and some lines deleted and inserted
  66. at your request.  Examine the demo.urexx file to see how this was
  67. created.
  68.